シス テム の 記事 ビギナー ズ 


ここ で は , コー ディ ング 規約 に つい て 考え る . コー ディ ング 規 
約 (コー ディ ング 工程 で の 管理 方 針 ) を 定め て お く こ と で , ソ 
フト ウェ ア の 不 ぐ あい の 発生 を ある 程度 抑え られ る . た だ し , 
関数 や 論理 値 の 正負 の 定義 , デー タ 構 造 な ど を よく 検討 し な い 
で 規約 を 作っ て し まう と , 形骸 化し て し まう . 単なる 「 お まじ 
な い 」 に な ら な い 規 約 の 作り か た , そし て 規約 の 運用 に あたっ 
て の 考え か た を 解説 する . (編集 部 ) 


D さ ん が リー ダ を つと め る プロ ジェ クト は , 1 週間 ほど 
前 に リリ ー ス を 終え た ば か り で す . ホッ と し た の も つか の 
間 , し ご と を 終え て 帰宅 し よう と し た D さ ん の と ころ に , 
リリ ー ス 先 の メー カ に 勤め て いる Q さ ん か ら 電話 が か か っ 
て きま し た . リリ ー ス され た モジ ュー ル を 組み 込ん だ と こ 
ろ , 正しい 結果 が 得 ら れず , と きど き シ ステ ム が ハン グ ア 
ッ プ する と いう の で す . 

まず D さ ん は , モジ ュー ル と いっ し ょ に 提供 し た リリ ー 
ス ・ ノ ー ト を 先方 に 確認 し て も ら う こと に し まし た . そし 
て , わか り に くい 点 な ど を 解説 し て み ま し た が , いずれ も 
問題 な く 組み 込ん だ は ず だ と いう 答え が 返っ て きま し た . 
そこ で D さ ん の プロ ジェ クト ・ サーバ に 保管 され て いる モ 


Stat1o short DATA LENGTH[40] = 


23923 Ja 2 


図 1 処理 系 バグ に 思え た エラ ー の 正体 

リリ ー ス 先 で 組み 込み 元 の ソー ス ・ コ ー ド を 見 る と , ライ ブラ リ 内 部 の 記述 
と 似 た よう な も の が 見 つか っ た . こう し た も の が あれ ば , リン ク ・ エ ラー を 
起こ す は ず . 起こ さなか っ た と いう こと は …. テー ブル だ け 組 み 込 まず に リ 
リー ス し た と いう オチ 


リリ ー ス し た ら 
テー アル が 
彰 を だ だ 12 


ジュ ー ル を 動か し て みた の で す が , 先方 が 指摘 する よう な 
現象 は 再現 で きま せん . 

手詰まり に な っ た D さ ん は , リリ ー ス 先 の Q さ ん の 会 社 
に お じゃ まし て モジ ュー ル の 組み 込み 状況 を 見 せ て も ら う 
こと に し まし た . し か し , モジ ュー ル の 引き 数 の 渡し か た 
な ど を 見 て も 異常 は み ら れ ませ ん .「 も し や , な ん ら か の 処 
理系 の バグ か な 」 と 思い か けた D さ ん の 目 に 偶然 飛び こん で 
きた の は , ライ ブラ リ の 呼び 出し 元 で ある 親 ルー チン の ソ 
ー ス ・ コ ー ド に 書か れ て いた 図 1 の よう な 記述 で し た . 

「 あれ , お か し い . この テー ブル 往 ! は 32 ビット 幅 の は ず 
だ . short 型 で は 正しく 動か な いん じゃ な い の か …. と い 
うか 待て よ . そもそも こん な 記述 が 呼び 出し 元 に ある の に , 
な ん で リン ク ・ エ ラー が 起き な いん だ ? 」. 

不安 に 思っ た D さ ん は , プロ ジェ クト の メン バ に 電話 し 
て , リリ ー ス し た ソー ス ・ コ ー ド を も う 一 度 確認 し て も ら 
えな いか と 連絡 し て みる こと に し まし た . 30 分 後に 返っ て 
きた 答え は 信じ られ な いも の で し た . 

「 リ リー ス 前 に 使っ て いた テス ト 用 関数 の ファ イル に テ 
ー ブ ル の 実体 を まち が えて 書い て し まっ て いた . その た め , 
リリ ー ス し た ライ ブラ リ に は この テー ブル の 実体 は 含ま れ 
て いな い 」. 

な ん と , ライ ブラ リ の 中 に 含ま れ て いる べき テー ブル の 
実体 が リン ク さ れ て いな か っ た と いう の で す . し か も , た 
また ま 呼び 出し 元 で 同名 の テー ブル が あっ た た め に リン 


注 1: 中 身 を 書き 換え ず , プロ グラ ム 起 動 時 か ら の 値 が 固定 で 用 いら れる 配 
列 の こと を テー ブル と 呼ぶ . 


テー ブル , コー ド ・ レ ビュ ー, コー ディ ング 規約 , ヘッ ダ ・ フ ァイル , define,。 プロ ト タイ プ 宣 言 , typedef, 


オブ ジェ クト 指向 言語 , 外部 変数 , ウォ ー タ フォ ー ル ・ モ デル 


132 Design Wave Magazine 2006 Ocfober 


ファ イル A 区 ファ イル B 図 
( テー ブル な し ) 図 ( テー ブル 1) 図 
( テー ブル 2) 図 
ファ イル C 凶 和志 図 
テー ブル 3) 区 の 
り ( テー ブル な し ) 較 
ファ イル E 図 ファ イル F 図 
( テー ブル な し ) 図 ( テー ブル 4) 図 


図 2 バラ バラ で 存在 する テー ブル は 保守 性 が 悪い 

な ぜ な ら , テー ブル は 外部 参照 し て いろ いろ な ファ イル で 使う も の で ある た 
め . どこ に な に が ある か わか ら な いと , 極め て 保守 性 の 悪い ソー ス ・ コード 
に な っ て し まう . 


ク ・ エ ラー を 起こ さなか っ た の で , リリ ー ス 先 で も 気づか 
な か っ た と いう こと で し た . 


⑯ テー ブル の 実体 , 論理 値 の 統一 に 問題 が 

D さ ん が 平 身 低 頭 し て 直ちに リリ ー ス を や り 直し た の は 
いう まで も あり ませ ん . 

うな だ れ て 帰っ て きた D さ ん は 翌日 , プロ ジェ クト の メ 
ン バ を 集め て ソー ス ・ コ ー ド ・ レ ビュ ー を 行う こと に し ま 
し た . そこ で 判明 し た の は , リリ ー ス し た ライ ブラ リ の ソ 
ス ・ コ ー ド は テー ブル の 実体 宣言 が 機能 ブロ ッ ク ご と に 
いろ いろ な ファ イル に また が っ て いて , ある テー ブル の 実 
体 が どこ に ある か は コー ド を 書い た 者 に し か わか ら な いと 
いう 事実 で し 怒 図 2). さら に 問題 だ っ た の は , 散ら ば っ 
た テー ブル の うち , いく つか は 機能 ブロ ッ ク 間 で 共通 に 使 
われ て いる と いう こと で し た . 

ソー ス ・ コ ー ド を さら に 細か く 読み 進め て みる と , ge 
fine 文 や プロ ト タイ プ 宣 言 の た ぐい も あちこち に バラ バ 
ラ に 存在 し て いま し た . 中 に は プロ ト タイ プ 宣 言 な し で 使 
われ て いる 関数 も ある よう で し た . 加え て 問題 だ っ た の は , 
ある 一 つの gefine 文 は 機能 プ ブロック に よっ て 論理 値 が 逆 
と な っ て いた こと で ず 図 3). 

外部 変数 も 実体 が あちこち に あり まし た . 外部 変数 を 使 
用 する こと は 設計 段階 で 必要 と 判断 し た も の で す が , その 
管理 に 問題 が ある こと は 否め な いよ う で す . 構造 体 や 変数 
型 の typedef も 散在 し て いる こと が わか り ま した. 


⑯「 お まじ な い 」 に な ら な いた め の コ ー デ ィング 規約 作り 
D さ ん の よう な 事態 に 陥っ た 場合 , 読者 の みな さん は , 
どう いっ た 解決 策 を 考え る で し ょ うか .「 そこ まで 自分 は 
ま ぬ け で は な い 」 と 思う 方 もい る か も し れ ま せん . そう い 


新人 技術 者 の た め の 


ロジ カル ・ シン キン グ 人 人 


機能 ブロ ッ ク A 


#QdeE1ne TRACE OFF 
#define TRACE ON 


機能 ブロ ッ ク B 


#QdeE1ne TRACE OFF 
#define TRACE ON 


図 3 論理 値 が 機能 ブロ ッ ク に よっ て 逆 と いう 例 

方 針 を まっ た く 決め ず に 複数 の 人 が コー ディ ング し て し まう と , こう いう こ 
と が 起こ りう る . 防止 する た め に は , ソー ス ・ コ ー ド の 書き か た の 規則 に 加 
え , 必要 な 論理 値 は 正負 を あら か じ め 決 め て お く と いう よう な 対策 が 必要 . 


バラ バラ の 定義 を 較 
どう する か ? 図 


ヘッ ダ ・ フ ァイル 凶 
に よる 集中 管理 較 


機能 共通 ヘッ ダ 図 
機能 別 ヘ ッ ダ 凶 
の 2 種類 較 


領域 を 持つ / 較 
持た な いで 較 
管理 を 分 ける 較 


図 4 コー ディ ング 規約 の 検討 

バラ バラ な 記述 が 混乱 を 生ん で いる 場合, それ ぞ れ を どの よう に 整理 すれ ば 
混乱 が お さま る か を まず 検討 する . この 過程 を スキ ッ プ し て いき な り 規 約 を 
作る と , 形骸 化し て し まう こと は 避け られ な い . 


各 定義 を ヘッ ダ に 較 
まとめ る 較 


う 方 は , 管理 が ボロ ボロ の まま ライ ブラ リ を 提供 し て し ま 
う 人 た ち を 引き 当て て し まっ た 管理 者 の Q さ ん に な っ た つ 
も り で 考え て みて くだ さい . 
まず だ れ で も 考え る で あろ うこ と は ,「 再発 防止 の た め 
に は , ソー ス ・ コ ー ド に な ん ら か の 規約 が 必要 な の で は な 
いか 」 と いう こと で し ょ う . これ に つい て は , 筆者 も 同じ 
意見 で す . し か し , コー ディ ング 規約 の た ぐい と いう も の 
は , 機械 的 に 作っ て 当て は め る だ け で す と 次 第 に 形骸 化し 
か ね ませ ん . そし て 最後 に は 根拠 の 不明 確 な , 単 な 人 が お 
まじ な い 」 の よう な も の に 陥る 危険 性 が ある の も 事実 で す . 
た いせ つ な の は , ここ で 起こ っ た よう な 混乱 を 生じ な いた 
め の し くみ 作り と し て の コー ディ ング 規約 作り だ , と いう 
こと を 念頭 に 置く こと で ず 図 4). 
そこ で D さ ん と いっ し ょ に , 上 述 の 問題 に つい て ソー 
ス ・ コ ー ド 規約 を 考え て みる こと に し まし ょ う . 手始め に 
D さ ん は , 「 定義 箇所 が バラ バラ 」 な も の を 挙げ て み ま し た 
( 図 5). 
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@ define 
etypedef 構造 体 や 変数 の 型 宣言 ) 較 
e プロトタイプ 宣言 凶 


テー ブル 凶 
e 外部 変数 較 


図 5 バラ バラ に 定義 され る と 混乱 の も と に な る も の 


例え ば , テー ブル が あちこち に 存在 し て どこ に 何 が ある の か わか ら な いよ う 
な 場合 , 冒頭 の 例 で 挙げ た よう な 定義 ミス が 起こ りう る . 


@ ヘッ ダ に まとめ る 管理 方 針 
さて , これ ら を 秩序 立て て 分 類する た め に は , どの よう 
に すれ ば よい で し ょ うか . define や typedef な ど は , 要 
する に 記述 が 秩序 だ て て 行わ れ て いれ ば よい の で す . 
define 用 , typedef 用 に つい て は , 以下 の よう な 方 法 が 
考え られ ます . 
1) 専用 の ヘッ ダ ・ フ ァイル に それ ぞ れ 定義 する 
2) 記述 の 順番 を 決め て , すべ て の 定義 を 一 つの ヘッ ダ に 
まとめ る 
1) は も っ と も 科 単 な 方 法 で す が , バラ バラ に 記述 され る 
の が 混乱 の も と な の で , それ を 人 避け る た め に qgefine や 
typedef を 別 の ヘッ ダ ・ フ ァイル に 分 け な い 2) の よう な 
方 法 も 採用 で きま す . 
1) ま た は 2) の いずれ か を 採用 すれ ば ぱ , 
バラ に 散乱 する こと は 防げ そう です. 


ヽ ょ ン 


定義 箇所 が バラ 


人 @ 領域 を 使う か 否 か で 管理 は 異な る 

「 だ が , ちょ っ と 待て よ 」 と , D さ ん は さら に 考え ます . 
「 define な ら と も か く , テー ブル な ど は どう し よう ? 」. 

な ぜ な ら , テー ブル は 領域 を 持っ て いる た め , 領域 を 持 
た な い 単 な る 型 家 言 と は 分 け て 考え な けれ ば な ら な い は ず 
だ か ら で す . ヘッ ダ ・ フ ァイル を 使っ て テー ブル の 管理 方 
針 を 考え る 場合 , どの よう な 方 針 が 考え られ る の で し ょ う . 

「 外部 変数 」 慎 テー ブル 」 な ど は , 変数 で ある た め 領域 
時 6I eee な は グリ ウロ も の 


ヘッ ダ ・ フ ァイル 図 


xx_ext.h 外部 変数 。 テー ブル 凶 


図 7 
ヘッ ダ に 領域 を 持た な い 解 決 策 
ー つ の 解決 策 と し て , 領域 を 持つ も の の 場合 


ィ ッ ッ ルー ド 理 


こ リン ク 凶 
領域 の 実体 を C ソ ー ス ・ ファ イル に まとめ て 定 各 C ソ ー ス ( 関数 ) 外部 変数 ーー 
ァイル に まとめ る . 国 
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@ defF1ine 
etypedef 構造 体 や 変数 の 型 宣言 ) er 
ゃ プロトタイプ 宣言 凶 
e テー ブル 凶 
e 外部 変数 囚 
図 6「 領域 を 持つ , 持た な い 」 で 管理 方 針 を 分 ける 
ヘッ ダ ・ フ ァイル で 定義 を 整理 する 場合 , 領域 を 持つ も の と 持た な いも の は 
管理 方 法 を 分 ける 必要 が ある . な ぜ な ら , 前 者 は ヘッ ダ ・ フ ァイル その も の 


に 領域 を 確保 し て し まう と , ヘッ ダ ・ フ ァイル を 複数 の ファ イル で イン クル 
ー ド で き な く な る か ら . 


) 領域 を 持つ 


が 置き 換え る だ け の も の で ある た め , それ その も の が 領域 
を 持つ わけ で は あり ませ ん . 
define な ど は 領域 を 持た な い の で , ヘッ ダ ・ フ ァイル 
に お いて も 何 の 問 題 も あり ませ ん . し か し , テー ブル な ど 
は 領域 を 持つ た め , 無 秩 皮 に ヘッ ダ に 集め て し まう と 多重 
定義 が 発生 し て リン ク 時 に エラ ー を 引き 起こ し て し まう こ 
に な り ま す . 
その 一 つの 解決 方 法 と し て , 
e 外部 変数 や テー ブル は , それ ら を 定義 むす る た め の ソ ー 
ファ イル を 用 意 し て , 実体 は そこ に 集め て し まう 
と いう も の が あり ます . そし て , 
ee ヘッダ ・ フ ァイル に extern 宣言 を 用 意 し , テー ブル や 外 
部 変数 が 必要 な ファ イル は その ヘッ ダ ・ フ ァイル を イン 
クル ー ド する 
よう に し ます . これ ら を 方 針 と し て 定め れ ば , テー ブル や 
外部 変数 の 参照 が 必要 な ファ イル か ら のみ ア クセ ス で きる 
よう に な り ま ず 図 . 


人 @ 機能 別 フ ァイル と 共通 部 品 の くく り 出 し 

商用 開発 され る よう な ソフ トウ ェ ア は , か な ら ず 機能 ブ 
ロッ ク が 分 けら れ て お り , それ ぞ れ に 担当 が 定め られ て い 
ます . コー ディ ング 規約 は ここ で どう いう 役割 を 果たせ ば 
よい の で し ょ うか . 

D さ ん は 機能 ブロ ッ ク ご と に 


ヘッ ダ ・ フ ァイル を 分 ける 


外部 参照 を 一 つの ヘッ ダ ・ 了 
ファ イル に まとめ る 図 


実体 を 一 つの ソー ス ・ 
ファ イル に まとめ る 図 


ブル の 実体 較 


に し まし た .「 この 後 , 2 次 開発 , 3 次 開発 を 行う 場合 
機能 ブロ ッ ク ご と に ヘッ ダ ・ フ ァイル を 更新 し て も ら え ば 
混乱 し な い は ず だ 」 と 考え た か ら で す . 

で は , 機能 ご と に 共通 の 部 品 は どう 9 機 

と に 開発 を 進め る に し て も , 共通 部 品 と いう も の は か 

な ら ず 出 て きま す . 軸 BMHe5IIGGO の 1 
うま い 設 計 の や りか た な の で す が , これ を コー ディ ング 規 
約 に 反映 させ な い 手 は な さそ う です. 

例え ば , 最初 は 機能 ご と に ルー ル に 従っ て ソー ス ・ コ ー 
ド を 作り 込ん で も らい ます . そし て , し か る べき タイ ミン 
グ で 打ち 合わ せ を 行う な ど し て 共通 部 品 を くく り 出 し , そ 
れ ら を 共通 ヘッ ダ に 入れ る , と いう 方 法 で 共通 部 分 を くく 
り だ すこ と が で きそう で す . 

つま り , ヘッ ダ ・ フ ァイル と し て 次 の 2 種類 を 用 意 する 

と に な り ま す . 
e 各 機 能 別 の ヘッ ダ ・ フ ァイル 
e 各 機能 共通 の ヘッ ダ ・ フ ァイル 


人 @ 構成 を た 決め た ら 順 番 も 決め る 
次 は define や typedef, プロ ト タイ プ 宣 言 な ど を 実 
際 に ヘッ ダ ・ フ ァイル に まとめ 直す 段階 で す . 
ヘッ ダ ・ フ ァイル の 構成 は 前 述 し た よう に, 「 記述 の 順 
番 を 決め て , すべ て の 定義 を 一 つの ヘッ ダ に まとめ る 」 と 


漂 


義夫 欠 だ の の 寺 駅 LN コ 
ロジ カル ・ シ ン キ ング 8 葵 、 


ます . そこ で , 一 つ に まとめ る と 混乱 が 生ずる 場合 は 
defFine や typedeE, プロ ト タイ プ 宣 言 ご と に ヘッ ダ ・ フ 
ァイル を 分 け て , 「 専用 の ヘッ ダ ・ フ ァイル に それ ぞ れ 定 
義 す る 」 と いう 方 法 を 採用 し ます . 

後者 の 場合 , 各 ソ ー ス ・ フ ァイル に イン クル ー ド する へ 
ッ ダ ・ フ ァイル の 順番 を 決め て お き , その 後 ,「 各 ソ ー ス ・ 
ファ イル は 決め ら れ た 順番 で ヘッ ダ を イン クル ー ド する 」 

よう に する と , 混乱 は 生じ な く な り ま す . この 構成 な ら あ 
えて 多重 イン クル ー ド を 行う 必要 は あり ませ ん . つま り , 
コー ディ ング 規約 と し て 多重 イン クル ー ド を 禁じ て し まう 
こと が で きま す . 

上 述 の か よう な コー ディ ング 規約 を 用 いて いれ ば , D さ ん 
の プロ ジェ クト で 起こ っ た テー ブル や gefine を めぐ る 大 
混乱 は 救え た こと で し ょ う . 

複数 の ソー ス ・ フ ァイル で 利用 され る よう な さま ざま な 
定義 は , 一 定 の 規則 に 従っ て ヘッ ダ ・ フ ァイル を 構成 し て 
そこ で 集中 管理 すれ ば , 開発 に 秩序 を も た らし うる 性 質 の 
も の で す . 以上 を まとめ る と , 図 8, 図 9 の よう に な り ま す . 


人 @ 規約 を 考え る うえ で の ポイ ント 
以上 , コー ディ ング 規約 の 作成 に あたっ て の 具体 例 を 挙 
げ ま し た . 次 に , 一 般 的 な が ユー ディ ング 規約 を 考え た 場合 
に 重要 と な る 事柄 に つい て 述べ ます . コー ディ ング 規約 を 


いう 方 法 が 一 つ あ り ま す . た だ し , この 方 法 を 用 いる と 行 
数 が 多く な り 過ぎ た り , 書き 換え が 頻繁 に 発生 に し て し まい 


ヘッ ダ ・ フ ァイル 凶 
exx defh define 較 
exx strh 構造 体 凶 


exx exth 外部 変数 。 テ ー ブ ル 凶 
exx_proh プロ ト タ イ プ 宣 言 


イン クル ー ド 


各 C ソ ー ス ( 関数 ) 図 

定め られ た 順に イン クル ー ド 罰 
( 多重 イン クル ー ド は 禁止 ) 較 
inoclude "xx def.h" 


inc]1ude "xx tr.h" リン ク 較 外部 変数 , 較 


include "xx ext.h" | テー ブル の 実体 図 


include "xx pro.h" XX_ext.C 


図 8 ヘッ ダ ・ フ ァイル に よる 管理 の 全体 像 


ー つ の ヘッ ダ ・ フ ァイル に まとめ た ほう が 見 や すく な る か も し れ な い . 


種類 ごと に ヘッ ダ ・ フ ァイル を 分 けた 例 . 規模 の 小さ い 場 合 , すべ て の 定義 


考え る うえ で は 次 の 2 点 が ポイ ント と な る と 考え ます . 
設計 工程 で の 検討 すれ は 規約 で は 救え な い 

e 規約 は 設計 方 針 と 調和 させ る こと 

順に 解説 し て いき ます . 


共有 ヘッ ダ ・ フ ァイル 凶 


#1nc1ude cmn def.h define 図 
#ino1ude cmn t11.h テー ブル 較 


( 2) 共通 化 で きる も の は 集め る 図 


A ブ ロッ ク 較 


B ブ ロッ ク 図 


1) 各 ブ ロッ ク で 図 | ,. 
#1nc1ude "a def . ヘッ ダ ・ ファ イル 肌 す CTude b def . 


#1nc1ude "a gtr. 人 gs #1nc1ude "bb gtr. 
#1nc1ude "a t11 . を 管理 #inc1ude "b て 11 . 
#1no1ude "a PrO. 


#1mo1ude "b pro・. 


図 9 共通 部 品 化 と 機能 分 け の や りか た 

図 8 の よう な や り か た を 各 機 能 ブ ロッ ク で 行う 場合 , 共通 化し た い 部 品 が で る 
こと が ある . それ ら は 共通 ヘッ ダ に まとめ て , 各 機 能 ブ ロッ ク で イン クル ー ド 
で きる よう に する . 
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設計 工程 で の 検討 も れ は 規約 で は 救え な い 
最初 に 強調 し て お きた い の は , コー ディ ング 規約 は あく 
まで コー ディ ング 工程 の 管理 方 針 だ と いう こと で ず あま 
り に あたり まえ の こと の よう だ が …). し か し 言い換えれ 
ば , コー ディ ング より 上 流 工程 に お ける 設計 な ど に 欠陥 が 
あっ て 混乱 が 生じ て いた 場合 は , コー ディ ング 規約 を 定め 
た と ころ で 解決 策 に な ら な い , と いう こと で す . 

すなわち , 設計 工程 で の 検討 られ は , ユー ディ ング 規約 
で は 救え な い の で す . 救え な い ば か り か, そもそも 守れ な 
い 規 則 が で き 上 が っ て し まい , 混乱 は 増す か も し れ ま せん . 

その よう な 例 と し て は , 本 連載 の 第 2 回 本 誌 2006 年 6 
月 号 , pp.60-66) で 紹介 し た よう に 外部 変数 が 無秩序 に 使用 
され て いる プロ グラ ム が 挙げ られ る と 思い ます . この よう 
な プロ グラ ム に お いて は , 外部 変数 の 管理 方 針 を 規約 で 定 
め た と ころ で ソー ス ・ コ ー ド の 保守 性 は た いし て 向上 し ま 
せん . な ぜ な ら , 外部 変数 の 無秩序 な 使用 は , デー タ 構造 
の 再 検討 を 抜き に し て は 解決 の し よう が な いか ら で す . 

すなわち , シス テム に と っ て 必要 と され る デー タ 構造 は 
どの よう な も の か を 検討 し , それ を 設計 に 反映 させ る よう 
に し な いと 保守 性 は 改善 し な いと いう こと で す . 

設計 段階 で の 検討 パコ ー デ ィング 規約 に 先立っ て 重要 と 
な る 場合 , 図 9 で 記述 し た よう な 共通 化 と 機能 分 け を 例 に 
と っ て 考え て みる こと に し ます . 

この 共通 化 と 機能 分 け と いう 作業 は , 当然 の こと な が ら 
設計 段階 で 検討 すべ き 作業 で す . コー ディ ング 規約 は , こ 
の 設計 段階 で の 検討 が スム ー ズ に 実装 に 移せ る よう に する 
く ふう に ほか な り ま せん . 

第 3 回 本 誌 2006 年 8 月 号 , pp.102-108) で 記述 し た よう 
に , シス テム の 機能 分 け と いう も の は 設計 の 最初 の 段階 で 
考え られ る 事 が ら で す . そし て その 機能 分 け に 従っ て 担当 
が 割り 振ら れ , 工程 表 が 組み 立て られ ます . 
その よう な 場合 , も ちろ ん 各 機 能 で 用 いら れる 共通 モジ 


| | テス ト 工程 凶 


設計 工程 較 


コー ディ ング 工程 


10 各 工 程 の 方 針 は 互い に 調和 させ る こと 

開発 言語 の 設計 思想 が 前 工程 の 設計 作業 その も の に 影響 を 与え る と いう の は , 
教科 書 的 な 知識 か ら は 本 未 転倒 の よう に 聞こ える が , 実際 の 開発 で は 見 落と 
せな い フ ァ ク タ と な っ て いる . 
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ュー ル な ど が 必要 と な っ て きま す . ヘッ ダ ・ フ ァイル の 共 
通化 と 機能 分 け の 方 針 は , この よう な 設計 段階 か ら の 共通 
部 品 の くく り 出 し と 機能 分 け を 具体 化す る コー ディ ング 工 
程 に お ける 作業 な の で す . 

し た が っ て , 設計 段階 で の 部 品 共通 化 に 問題 が ある 場合 
は , 後 工程 の コー ディ ング 規約 で それ を 救う こと は で きま 
せん . 設計 段階 で 検討 すべ き 事 が ら を コー ディ ング 規約 で 
救 お うと し て も 救い きれ な いと いう こと で す . 

図 3 で , 論理 値 が 機能 ブロ ッ ク ご と に バラ バラ な 例 を 挙 
げ ま し た . 各 機 能 で 共通 に 扱う よう な 論理 値 は 。 ほん と う 
は コー ディ ング 前 の 設計 の 段階 で あら か じ め 定 め て お いた 
ほう が よい で し ょ う . 

シス テム の デフ ォ ル ト 値 は ゼロ が 正しい か , 非 ゼ ロ が 正 
し いか , な ど と いう こと は 絶対 的 な 基準 が ある わけ で は あ 
り ま せん . ある シス テム で は ゼロ を と れ ば デフ ォ ル ト 値 の 
意味 に な っ て いて , マイ ナス 値 は な ん ら か の 異常 を 表す か 
も し れ ま せん . また ある シス テム で は , ′ 1 が デフ ォ ル ト 
値 で あっ て ,' 2 ,′ 3 と いう 値 は な ん ら か の 特別 な 場合 を 
表す の か も し れ ま せん . 

この よう な こと は , シス テム 全体 の 要請 を 考慮 し な が ら 
決定 すべ き 事 が ら で す . 個人 の 好み は あっ て も , 絶対 的 な 
正解 と いう も の は か な ら ず し も 存在 し ませ ん . た だ し , 全 
体 の 方 針 で 調和 が と れ て いな か っ た ら , 確実 に 混乱 の も と 
に な り ま す . 図 9 で は , 共通 ヘッ ダ と 機能 別 ヘ ッ ダ を 分 け 
る 方 法 の 一 例 を 紹介 し て いま す . この コー ディ ング 規約 も , 
設計 段階 コー ディ ング の 一 歩 手 前 の 内 部 設計 も 含む ) で 検 
討 し た 事 が ら を 反映 する よう に し な いと , プロ グラ ム の 保 
守 性 は 期待 し た ほど は 向上 し て くれ ませ ん . 

2) 規約 は 設計 方 針 と 調和 させ る こと 

コー ディ ング 規約 は , 設計 と いう 上流 工程 で 定め られ た 
方 針 と 調和 し た も の で な けれ ば な り ま せん 図 10). 

例え ば , Java な どの オブ ジェ クト 指向 言語 で よく 採用 さ 
れる よう な , クラ ス ご と に ソー ス ・ フ ァイル を 分 け て ソー 
ス ・ フ ァイル と 同名 の ヘッ ダ ・ フ ァイル に クラ ス や 構造 体 
の 定義 を 集め て 構成 し て いく と いう 方 針 を と っ て いる 場合 
な ど は , 本 稿 で 述べ た よう な 管理 方 針 を その まま 採用 で き 
ませ ん . その よう な 構成 の 場合 , プ ロト タイ プ 宣 言 や 構造 
体 を クラ ス ご と に 別々 の ヘッ ダ ・ フ ァイル に 入れ な いで 共 
通化 し て し まう と , ソー ス ・ コ ー ド が 書け な いか ら で す . 
オブ ジェ クト 指向 を 設計 方 針 と し て 採用 し , その た め に オ 
ブ ジ ェクト 指向 言語 を 実装 に 用 いる と , 結果 と し て コー デ 


ィング 規約 に も 影響 を 及ぼ す と いう こと で す . 
@ 規則 は 趣旨 を 考え て 運用 する 

な ん ら か の 規則 を 定め た 場合 , それ を 適切 に 運用 する に 
は 趣旨 を 考え る こと が と て も た いせ つ で す . 図 4 に 示し た 
よう な ソー ス ・ コ ー ド の 管理 方 針 の 趣旨 は , 要する 同 集 
時 に よっ て 混乱 を 防ぐ 」 と いう も の で す . だ と すれ ば ぱ , 
機能 ご と に クラ ス を 分 ける コー ディ ング を 採用 する 場合 
同じ 考え が 応用 で きる は ず で す . すなわち , define や テ 
ー ブ ル に 関し て は , 集中 管理 する 方 針 が 採用 で きる と いう 
こと で す . 

そう で は な く ,「 ヘッ ダ ・ フ ァイル は , 構造 体 や define, 
プロ ト タイ プ 宣 言 , テー ブル に 分 け , 各 関 数 共通 で 用 いる 
も の だ 」 と 結論 だ け 覚 え こ ん で いた 人 が いた と し た ら , や 
っ か いで す . その よう な 人 は , ここ で 解説 し た よう な ヘッ 
ダ ・ フ ァイル の 管理 方 法 を 身 に つけ た と し て も , 慣れ な い 
プロ グラ ム 言 語 に 初め て 接し た 場合 に は な か な か 対応 で き 
な いこ と に な り ま す . 

逆 に , 設計 と コー ディ ング 規約 が 合致 する 例 を 挙げ て み 
まし ょ う . デー タ 構造 は 設計 段階 で 検討 すべ き 事 が ら で す 
が , この 方 針 が 定まっ た うえ で , それ と 調和 の と れ た コー 
ディ ング 規約 を 採用 する と , コー ディ ング の 工程 に お ける 
実装 が スム ー ズ に 進め られ ます . 

連載 第 2 回 で は , デー タ 構造 を 検討 し た うえ で , スタ テ 
イッ ク ・ デ ー タ , ダイ ナミ ッ ク ・ デ ー タ , テー ブル , ロー 
カル 変数 の 4 種類 の デー タ が あり うる こと を 解説 し まし た . 
これ ら を 本 稿 で 紹介 し た コー ディ ング 規約 に あて は め れ ば 
うま くい く は ず で す , 

第 2 回 で は , スタ ティ ッ ク ・ デ ー タ と ダイ ナミ ッ ク ・ デ 
ー タ に つい て は , 構造 体 に それ ぞ れ まとめ こん で し まう 構 
成 を と る よう に し て いま し た . つま り , 上 述 の よう な 規約 


皿 


表 1 デー タ 構 造 と コー ディ ング 規約 
設計 工程 で 検討 し た 事 が ら が スム ー ズ に 実装 され る よう に く ふ うす る の が コ 
ー デ ィング 規約 の 趣旨 . し た が っ て , 設計 者 が 開発 言語 に 不慣れ で あっ て は 
な ら な い . 
デー タ 構 迄 第 2 回 参照 ) 
スタ ティ ッ ク ・ デ ー タ 
ダイ ナミ ッ ク ・ デ ー タ 


コー ディ ング 規約 


構造 体 ヘッ ダ に 定義 


テー ブル テー ブル 用 ヘッ ダ に 定義 


ロー カル 変数 ヘッ ダ で の 分 類 は な し 


defFine 


プロ ト タイ プ 宣 言 


夫 洒 5 稚 だ の の トド 駅 に は つ 
ロジ カル ・ シ ン キ ング 人 上 


を 採用 する 場合 は , 構造 体 用 ヘッ ダ ・ フ ァイル に まとめ て 
定義 すれ ば よい こと に な り ま す . 

テー ブル に つい て も , 今回 の コー ディ ング 規約 で 管理 方 
針 が 定め られ て いま す . すなわち , C ソ ー ス ・ フ ァイル に 
実体 を 定義 し , ヘッ ダ ・ フ ァイル に extern 宣言 を まとめ 
れ ば よい で し ょ う . 

ロー カル 変数 は 領域 の 小さ な 変数 に 限定 し て 関数 ご と に 
定義 され て 用 いら れる も の , と いう の が 第 2 回 に お ける 方 
針 で し た . し た が っ て , ヘッ ダ ・ フ ァイル で 共通 管理 を 行 
う 必要 は と くに あり ませ ん . まとめ る と 表 1 の よう に な り 
ます . 


@⑯「 工 程 」 と いう も の の 考え か た 

以上 ,「 設計 工程 で の 検討 も れ は 規約 で は 救え な い 」, 「 規 
約 は 設計 方 針 と 調和 させ る こと 」 と いう 二 つ の ポイ ント に 
つい て 解説 し まし た . 

実 の と ころ , これ ら 二 つ は 独立 し た 方 針 と いう より は む お 
し ろ 互 い に 補 い 合 う も の で す . な ぜ な ら 両 者 は , 各 工 程 の 
成果 物 を どの よう に 定義 し , 期日 を 定め る か と いう , ソフ 
トウ ェ ア 開 発 管理 に お いて も っ と も か な め と な る 事 が ら に 
密接 に か か わっ て くる か ら で す . 
工程 ご と に その 趣旨 と 成果 物 を よく 検討 する こと は た い 
せつ で ず 図 11). この こと は , いわ ゆる 教科 書 的 な ウォ 
ー タ フォ ー ル ・ モ デル を 採用 し な いよ うな 開発 で あっ て も 
変わ る こと は あり ませ ん . 

た だ し , 教科 書 的 な ウォ ー タ フォ ー ル ・ モ デル に と ら わ 
れる と 見 落と し が ち に な る の が ,「 工程 間 の 調和 」 と いう 観 
og 

教科 書 の 中 な らい ざし ら ず , 実際 の 組み 込み シス テム の 
開発 の 場面 いか に 実装 する か 」 を まっ た く 考 え ず け 何 
を 作る か 」 を 考え る こと は あり ませ ん . 実際 に コー ディ ン 
グ を 始め な いと 問題 点 に 気づか な い , と いう の で は 何 の た 

め に 設計 工程 が あっ た の か わか ら な く な っ て し まい ます . 


図 11 工程 に は 調和 と 独立 性 が 求め られ る 

教科 書 的 な ウォ ー タ フォ ー ル ・ モ デル を 採用 し ない 場 合 で あっ て も , 開発 チ 
ー ム を 率い る 人 は , 各 工 程 の 趣旨 と その 成果 物 を 入念 に 考え て お く 必要 が あ 
る . その うえ で 各 工 程 を 調和 させ る こと も た いせ つ . 
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組み 込み シス テム は ハー ド ウェ ア ・ リ ソー ス に 強い 制約 
が あり ます . し た が っ て ,「 いか に 実装 する か 」 を まっ た く 
考え ず 何 を 作る か 」 だ け 考 えて し まえ ば , 実装 不可 能 
な 仕様 を 定め て し まっ た こと に 後 か ら 気づく こと に も な り 
か ね ませ ん . 仕様 と し て 定め られ た 機能 が いか に 魅力 的 で 
も , 現状 の ハー ド ウェ ア で 実装 で き な い も の で あれ ば アウ 
ei MM 

し た が っ て , ウォ ー タ フォ ー ル ・ モ デル の 基本 的 な 考え 
か た と され る what を 考え て か ら how を 考え る 」 と いう の 
は , 机上 の 空論 で ある と 少な く と も 筆者 は 考え ます . つね 
に 後 工程 で の 作業 も 視野 に 入れ な が ら , あら か じ め 問 題 点 
を 先取 り し , 一 つ ー つ の 工程 に お ける 作業 内 容 を 確定 で き 
る こと が 管理 者 に 求め られ る 資質 と いえ る で し ょ う . 


人 @ 外部 変数 は 最小 限 に 絞り 込ん で 

最後 に , 外部 変数 の 使用 に つい て 少し 補足 し て お きま す . 

外部 変数 に つい て は , 連載 第 2 回 で な ぜ そ れ が 必要 な の 
か を 検討 し まし た . また , デー タ 構造 の 例 と し て は リー ド 
の み の 外 部 変数 で ある テー ブル 以外 を 禁止 し て し まう や り 
か た を 解説 し まし た . 

本 稿 で は 逆 に , 外部 変数 を と くに 禁止 し な い 手 法 を 解説 
し て いま す . し か し そう は いっ て も , 外部 変数 が むやみ や 
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た ら と 使わ れる の は あま り 望ま し いこ と で は あり ませ ん . 
「 必要 性 を 吟味 し て , 必要 最小 限 の も の に 絞り 込む こと が 
望ま ほしい 」 と 考え られ ます . 数 が 少な けれ ば , 頭 に 入れ た 
うえ で ソー ス ・ コ ー ド を メン テ ナ ン ス で きる の で , 弊害 が 
大 きく な る こと は な いと 思わ れる か ら で す . 

外部 変数 の 採用 方 針 は コー ディ ング 規約 の 中 で 定め る 事 
が ら で す . し か し , 外部 変数 を 使う か どう か , また 使う の 
で あれ ば どの 程度 な の か と いう 問題 は , 実 の と ころ デー タ 
構造 を いか に 定め る か と いう 設計 工程 に お ける 検討 と 密接 
に か か わっ て きま す . 

繰り 返し に な り ま す が , 外部 変数 に つい て は , 設計 工程 
と よく 調和 する 形 で 管理 方 針 を 定め , 必要 最小 限 の も の に 
絞り 込む こと が 望ま し いと 思い ます . 


の 3 
AM 
集 


・ はじめ 


筆者 プロ フィ ー ル ツ 

沈 木 元 . シス テム ・ エ ンジ ニア . 刷り 上 っ た 8 月 号 の 自分 の 記事 を 見 
て ビッ クリ . な ん と フロ ー チ ャ ー ト が まち が っ て いる で は な いか ! 筆 
者 校正 は や は り ま じ め に や る べき と いう 戒め か も し れ な い . 読者 の み 
な さん すみ ませ ん . 


